SYSTEM AND METHOD OF MAPPING BETWEEN SOFTWARE OBJECTS AND 
STRUCTURED LANGUAGE ELEMENT BASED DOCUMENTS 



Field of the Invention 

The present invention relates to the field of converting or mapping between a software object 
and a structured language element document, and in particular to mapping between various 
software objects such as Java™ objects and Extensible Markup Language (XML) documents. 

Background of the Invention 

Extensible Markup Language (XML) is a pared down version of Standard Generalized Markup 
Language (SGML) that is designed especially for Web documents. It enables designers to create 
their own customized tags to provide functionality not available with HTML. For example, 
XML supports links that point to multiple documents, as opposed to HTML links, which can 
reference just one destination each. 

Because XML is a form of self-describing data (also termed structured language elements in the 
present description), it is used to encode rich data models. Therefore, XML is useful as a data 
exchange medium between dissimilar systems. Data can be exposed or published as XML from 
many kinds of systems: legacy COBOL programs, databases, C++ programs and the like. A 
business problem that is commonly encountered involves resolving how to map information 
from an XML document to other data formats and vice versa. For example, once information 
has been exchanged between entities in an XML document, it may be necessary to map its 
information into a Java object that can be used when making a database or transactional request. 

U.S. Patent 6,125,391 issued September 26, 2000 to Meltzer et al. discloses an example of an 
XML/Java conversion tool. For converting from XML to Java, Meltzer et al. parse the XML 
document and raise events. In particular, a parser walks through an XML document and builds a 
tree representation in memory that can be queried and another parser walks an XML document 
and raises events with information about the document (e.g., start document event, start element 
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event with the name of the element, content of the element, end element event, end document 
event, etc.). 

For converting from Java to XML, Meltzer et aL generates code that contains accessors for each 
5 element. The accessor for an element contains a loop, looping for each character. The loop 

contains a switch statement that performs an action based on what the character is. The action is 
to build a StringBuffer containing the element fragment of the XML document. The Meltzer et 
al. solution does not provide supporting infrastructure for working with the code that transforms 
Java to XML. All the code in Meltzer et al. is generated and is not conducive for a user to edit. 

10 

Consequently, there is a need for a mapping framework to support mapping between software 
objects and structured language element based documents (e.g. XML) that can be efficiently 
implemented using standard tools. 

1 5 Summary of the Invention 

The disadvantages of the prior art summarized above are overcome according to an exemplary 
method and system of the present invention that provides a common framework for mapping 
between a document (e.g. an XML document) and a software object (e.g. a Java object). The 
framework uses a handler that masks how a property is obtained for mapping. This results in 
20 mapping code that has a common appearance for both directions of mapping. A mapping 

between elements of an XML document and the properties of a Java object is contained in a 
mapper. A mapper maps from the XML document to a software object through the use of a 
parser (such as Document Object Model (DOM) or Simple Application Programming Interface 
(API) for XML (SAX)). 

25 

Mapping in the other direction (Java to XML) requires that the elements of the XML document 
be built in a particular order to ensure validity of the resulting XML document. To ensure this 
validity, an exemplary embodiment of the present invention builds an XML template document 
using JavaServer Pages™ (JSP), for example. Using JSP based templates enables tags of the 
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document to be written in the JSP, with callbacks to get element and attribute values. JSP is well 
documented with editor support to permit efficient template creation. Further, content can be 
directed to a buffer, or directly to a response stream of a servlet. 



5 In accordance with one aspect of the present invention there is provided a computer- 
implemented method for converting a data structure representing a software object to structured 
language elements of a document, the method comprising: (a) generating a structured language 
element template document; (b) reading properties from the software object, the properties being 
associated with the structured language elements of the document; (c) using the properties, 
10 obtaining constructs defined by the structured language elements based on the association 
between the properties and the structured language elements; and (d) populating the structured 
language element template document with the constructs. 

In accordance with another aspect of the present invention there is provided a computer- 
15 implemented method for converting structured language elements of a document to a data 

structure representing a software object, the method comprising: (a) reading each of the 
structured language elements of the document; (b) determining a property, selected from a set of 
available properties defined by the data structure of the software object, associated with 
structured language elements of the document; and (c) populating the properties of the data 
20 structure representing the software object with structured language element values from the 
document. 

In accordance with another aspect of the present invention there is provided a system for 
converting a software object containing properties to a document defined by structured language 
25 elements, the system comprising: (a) a document template; (b) a handler interface for providing 

a representation of the structured language elements of the document based on call backs made 
by the document template; (c) a mapping module, in communication with the handler interface, 
for converting properties of the software objects to structured language elements recognized by 
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the document; and (d) an output target class, in communication with the mapping module, for 
writing the structured language elements generated in step (c) to the document. 

5 In accordance with another aspect of the present invention there is provided a system for 

converting a document containing structured language elements to a software object, the system 
comprising: (a) a parser for obtaining events representative of features of the document; (b) an 
input source class for reading the document; (c) a content handler class, in communication with 
the input source class, for implementing a buffer for the events obtained by the parser; and (d) a 
10 mapping module, in communication with the content handler class, for converting the events 
obtained by the parser to properties for the software object. 

In accordance with another aspect of the present invention there is provided a method of 
converting a software object having properties to a document represented by structured language 
15 elements, the method comprising: (a) supplying the software object to an instance of an invoked 

mapping interface; (b) compiling and executing a template using an instance of an invoked 
container; and (c) writing the document to a specified output stream using the compiled 
template. 

20 In accordance with another aspect of the present invention there is provided a method of 
converting a document containing structured language elements to a software object, the method 
comprising: (a) supplying the document to an instance of an invoked mapping interface; (b) 
registering the mapping interface as a content handler; (c) parsing the document using an 
instance of an invoked parser; and (d) populating the software object with properties associated 

25 with structured language elements parsed from the document through call backs made to the 
mapping interface. 

In accordance with another aspect of the present invention there is provided a computer program 
product for converting a data structure representing a software object to structured language 
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elements of a document, the computer program product comprising computer readable program 
code devices for: (a) generating a structured language element template document; (b) reading 
properties from the software object, the properties being associated with the structured language 
elements of the document; (c) using the properties, obtaining constructs defined by the structured 
5 language elements based on the association between the properties and the structured language 

elements; and (d) populating the structured language element template document with the 
constructs. 

In accordance with another aspect of the present invention there is provided a computer program 
10 product for converting structured language elements of a document to a data structure 
representing a software object, the computer program product comprising computer readable 
program code devices for: (a) reading each of the structured language elements of the document; 
(b) determining a property, selected from a set of available properties defined by the data 
structure of the software object, associated with structured language elements of the document; 
15 and (c) populating the properties of the data structure representing the software object with 

structured language element values from the document. 

Other aspects and features of the present invention will become apparent to those ordinarily 
skilled in the art upon review of the following description of specific embodiments of the 
20 invention in conjunction with the accompanying figures. 

Brief Description of the Drawings 

Further features and advantages of the present invention will be described in the detailed 
description, taken in combination with the appended drawings, in which: 
25 Fig. 1 is a block diagram of a computer system that may be used to implement a method 

and apparatus for embodying the invention; 

Fig. 2 is a block diagram illustration the framework for mapping between XML and Java 
objects and vice versa; 
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Fig. 3 is a flow chart illustrating a method of mapping an XML document to a software 
object using the framework of Fig. 2; and 

Fig. 4 is a flow chart illustrating a method of mapping a software object to an XML 
document using the framework of Fig. 2. 

5 

Detailed Description of Embodiments of the Present Invention 

Fig. 1 and the associated description represent an example of a suitable computing environment 
in which the invention may be implemented. While the invention will be described in the 
general context of computer-executable instructions of a computer program that runs on a 
10 personal computer, the invention can also be implemented in combination with other program 
modules. 

Generally, program modules include routines, programs, components, data structures and the 
like that perform particular tasks or implement particular abstract data types. Further, the 

15 present invention can also be implemented using other computer system configurations, 
including hand-held devices, multiprocessor systems, microprocessor-based or programmable 
consumer electronics, minicomputers, mainframe computers and the like. The invention can 
also be practiced in distributed computing environments where tasks are performed by remote 
processing devices that are linked through a communications network. In a distributed 

20 computing environment, program modules may be located in both local and remote memory 
storage devices. 

With reference to Fig. 1, an exemplary system 10 includes a conventional personal computer 20, 
including a processing unit 22, a system memory 24, and a system bus 26 that couples various 
25 system components including the system memory 24 to the processing unit 22. The system bus 
26 includes several types of bus structures including a memory bus or memory controller, a 
peripheral bus, and a local bus using any of a variety of conventional bus architectures (e.g., PCI, 
VESA, ISA, EISA etc.) 
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The system memory 24 includes read only memory (ROM) 28 and random access memory 
(RAM) 30. A basic input/output system (BIOS) 32, containing the basic routines that help to 
transfer information between elements within the computer 20, such as during start-up, is stored 
in the ROM 28. The computer 20 also includes a hard disk drive 34, magnetic disk drive 36 (to 
5 read from and write to a removable disk 38), and an optical disk drive 40 (for reading a CD- 
ROM disk 42 or to read from or write to other optical media). The drives 34, 36 and 40 are 
connected to the system bus 26 by interfaces 44, 46 and 48, respectively. 

The drives 34, 36 and 40 and their associated computer-readable media (38, 42) provide 
10 nonvolatile storage of data, data structures, and computer-executable instructions for the 

computer 20. The storage media of Fig. 1 are merely examples and it is known by those skilled 
in the art to include other types of media that are readable by a computer (e.g., magnetic 
cassettes, flash memory cards, digital video disks, etc.). 

15 A number of program modules may be stored in the drives 34, 36 and 40 and the RAM 30, 

including an operating system 50, one or more application programs 52, other program modules 
54 and program data 56. A user may enter commands and information into the computer 20 
through a keyboard 58 and an input device 60 (e.g., mouse, microphone, joystick, game pad, 
satellite dish, scanner etc.) These devices (58 and 60) are connected to the processing unit 22 

20 through a port interface 62 (e.g., serial port, parallel port, game port, universal serial bus (USB) 
etc.) that is coupled to the bus 26. A monitor 64 or other type of display device is also connected 
to the bus 26 through an interface 66 (e.g., video adapter). 

The computer 20 may operate in a networked environment using logical connections to one or 
25 more remote computers, such as remote computer 68. The remote computer 68 may be a server, 
a router, a peer device or other common network node, and typically includes many or all of the 
elements described in relation to the computer 20, although for simplicity only a memory storage 
device 70 is shown. The logical connections shown in Fig. 1 include a local area network (LAN) 
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72 and a wide area network (WAN) 74. Such networking environments are commonly used in 
offices, enterprise-wide computer networks, intranets and the Internet. 

When used in a LAN networking environment, the computer 20 is connected to the LAN 72 
5 through a network interface or adapter 76. When used in the WAN networking environment, the 
computer 20 typically includes a modem 78 or other means for establishing communications 
over the WAN 74, such as the Internet. The modem 54, which may be internal or external, is 
connected to the bus 26 through the port interface 62. In a networked environment, program 
modules depicted relative to the computer 20, or portions thereof, may be stored in the remote 
1 0 memory storage device 70. 

Discussion of the method of the present invention is based in terms of conversion/mapping from 
XML to Java objects and from Java objects to XML. Other data formats are also supported. For 
example, many legacy business applications are written in COBOL, C and PL1. These 

15 applications are composed of programs that reside in Enterprise Information Systems (EIS) such 
as CICS™ (general purpose online transaction processing software) or IMS™ (Information 
Management System). A COBOL program uses COBOL structures for their input and output. 
There is a need to map from XML to COBOL and from COBOL to XML. The present invention 
can be used to perform these maps, where a XML-to-object X mapping handler (discussed 

20 below) would populate a COBOL structure from the XML document and an object-X-to-XML 
mapping handler (discussed below) would extract the data from a COBOL structure and be used 
by a template to populate the XML document. 

By way of background, the mapping methods of the present invention utilize the following high 
25 level process: (a) a lexer groups characters into words or tokens that are recognized by a 
particular system (termed tokenizing); (b) a parser analyses groups of tokens in order to 
recognize legal language constructs; and (c) a code generator takes a set of legal language 
constructs and generates executable code. The functions defined by (a)-(c) can be intermixed. 
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For example, for XML to Java object mapping, every character in a XML document is analyzed 
in order to recognize legal XML tokens such as start tags, properties, end tags and "COATA" 
sections. Then, the tokens must be verified that they form legal XML constructs. At a most 
basic level, it is verified that all of the tagging has matching opening and closing tags and the 
5 properties are properly structured in the opening tag. If Document Type Definitions (DTD) or 
XML schema are available, then it is possible to ensure that the XML constructs found during 
parsing are legal in terms of the DTD or XML schema as well as being well-formed XML. 
Finally, the data contained in the XML document is used to accomplish something useful (i.e. 
map it into a Java object). 

10 

Some of the tasks identified above can be performed, at least in-part, by readily available XML 
parsers. XML parsers handle the lexical analysis and parsing tasks. Two example parsing 
standards are the SAX and DOM APIs (SAX - Simple Application Programming Interface (API) 
for XML; DOM - Document Object Model). 

15 

SAX is event-based. XML parsers that implement SAX generate events that correspond to 
different features found in the parsed XML document. The DOM API is an object-model-based 
API. XML parsers that implement DOM create a generic object model in memory that 
represents the contents of the XML document. Once the XML parser has completed parsing, the 
20 memory contains a tree of DOM objects that offers information about both the structure and 
contents of the XML document. 

Fig. 2 illustrates a schematic representation of a framework 100 according to an embodiment of 
the present invention. The framework 100 is shown instantiated in an integration component 
25 102 such as a Servlet that can be executed in the system 10 of Fig. 1. The integration component 

102 includes a parser 104 implemented using DOM or SAX, for example, that interacts with an 
XML-OBJECT mapping module 106. For clarity, SAX will be discussed as an example of the 
parser 104 in describing the implementation embodiments of the present invention. 
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The XML-OBJECT mapping module 106 receives an input XML document 108 and generates 
an output Java object 1 10. The integration component 102 further includes an XML document 
template module 112 (e.g. based on JavaServer Pages™ - JSP technology) that communicates 
with an OBJECT-XML mapping module 114. The OBJECT-XML mapping module 114 
5 receives an input Java object 1 1 6 and generates an output XML document 118. 

XML TO SOFTWARE OBJECT MAPPING 

With reference to Fig. 2, the XML-OBJECT mapping module 106 includes the following 
components: 

10 (a) an input source class 106-1 (XML2xInputSource) for implementing the input XML 

document 108; 

(b) a buffered content handler class 106-2 (XML2xBufferedContentHandler) for 
implementing a buffer for SAX events generated by the parser 104; 

(c) a mapping interface 106-3 (XML2xMapping) for executing the mapping and for 
15 setting input and output target streams; and 

(d) a mapping class 106-4 (XML2xMappingImpl) that provides methods for mapping 
from the input XML document 108 to the output Java object 1 10. 

Further details of the various interfaces and classes are discussed below. The terms "class" and 
20 "interface" have specific meanings in Java. A Java class (abstract, inner or final) is a collection 
of data members and methods that define a particular object and a Java interface is used to 
impose certain functionality on a class that implement them (i.e. interfaces specify what classes 
must do). Interfaces are also used to provide constants that can be used by the classes that 
implement the interface. Interfaces contain constant variables and method declarations, but the 
25 implementation of the methods is left to the classes that implement the interface. A class can 
implement any number of interfaces. 

Table M106-1 summarizes the main functions (i.e., not exhaustive) of the input source class 106- 
1 (XML2xInputSource). 
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XML2xInputSource is used so that an XML document can be read from a byte stream, a 
character stream or the XML2xBufferedContentHandler 106-2. 

TABLE Ml 06-1 



FUNCTION 


DESCRIPTION 


available () 


Returns the number of bytes that can be read from an input stream 
without blocking. 


getBufferedHandler () 


Gets the SAX event buffered handler. 


getByteStream () 


Returns a byte stream 


getCharacterStream () 


Returns a character stream reader. 


read 0 


Reads the next byte of data from this input stream. 


skipO 


Skips bytes of input from this input stream. 



Table Ml 06-2 summarizes the main functions (i.e., not exhaustive) of the buffered content 
handler class 106-2 (XML2xBufferedContentHandler). The handler class 106-2 also includes a 
content handler to buffer SAX events from the parser 104. This allows events to be replayed. 
An example where this feature is useful is where different mapping handlers are used for 
different portions of an XML document. An implementation example is the Simple Object 
Access Protocol (SOAP). 
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TABLE Ml 06-2 



FUNCTION 


DESCRIPTION 


characters (char[] ch, int start, int length); 


Method comment where ch are characters 
from the XML document 108; start is the 
start position in the array; length is the 
number of characters to read from the array 


parseQ 


Executes SAX events in the buffer 



SOAP is a lightweight protocol for exchange of information in a decentralized, distributed 
environment. It is an XML based protocol that consists of three parts: (1) an envelope that 

10 defines a framework for describing what is in a message and how to process it; (2) a set of 
encoding rules for expressing instances of application-defined data types; and (3) a convention 
for representing remote procedure calls and responses. A SOAP message is an XML document 
that consists of a mandatory SOAP envelope, an optional SOAP header, and a mandatory SOAP 
body. In this situation, it is possible to use a different mapping handler for the envelope and the 

15 body. 

Table Ml 06-3 summarizes the main functions (i.e., not exhaustive) of the mapping interface 
106-3 (XML2xMapping). XML2xMapping executes the mapping and allows configuration of 
the InputStream. 
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TABLE Ml 06-3 



FUNCTION 


DESCRIPTION 


executeQ 


Performs the mapping that will create the format from the input 
XML document 108. A full example of executeQ is provided 
below. 


setlnputStreamQ 


Sets the input stream - i.e., specifics the source of the input 
XML document 108 that is to be mapped. 



Table Ml 06-4 summarizes the main functions (i.e., not exhaustive) of the mapping class 106-4 
(XML2xMappingImpl). As discussed above in relation to the definitions of class and interface, 
10 the XML2xMappingImpl class is not used directly, but is sub-classed with content added to 
appropriate methods depending on document type definitions for the input XML document 108 
to be mapped from the output Java object 1 10 it is mapping to. 

TABLE Ml 06-4 

15 



FUNCTION 


DESCRIPTION 


endElement() 


Receives notification of the end of an element. The parser 104 
will invoke this method at the end of every element in the 
input XML document 108. There is a corresponding 
startElement() event for every endElement - event even when 
the element is empty. 


execute() 


Performs the mapping that will create the format from the 
input XML document 108 


setDocumentLocator() 


Receives an object for locating the origin of SAX document 
events. 


setlnputStreamQ 


Sets the input stream. Specifies the source for the XML 
document that is to be mapped. 
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FUNCTION 


DESCRIPTION 


startElementQ 


Receives notification of the beginning of an element. The 
parser 104 invokes this method at the beginning of every 
element in the input XML document 108. There is a 
corresponding endElementQ event for every startElementQ 
event - even when the element is empty. All of the element's 
content is reported, in order, before the corresponding 
endElementQ event. 



With reference to Fig. 3, a method 300 is illustrated showing the general steps that are performed 
to map the XML document 108 to the software object 1 10 (e.g., a Java Bean): 
5 (a) obtain an instance of the mapping interface 106-4 (e.g., XML2XMapping) for 

implementing the mapping from XML to object X at step 302; 

(b) invoke the mapping interface 106-4 at step 304 and supply the input XML document 
108 at step 306; 

(c) the mapping interface 106-4 obtains an instance of an event parser (e.g., the parser 
10 104) at step 308 and registers the mapping interface 106-4 as a content handler (e.g., 

buffered content handler class 106-2) at step 310; 

(d) invoke the parser 104 on the XML document 108 (i.e., begin parsing the document) at 
step 312; 

(e) as step (d) is performed, call backs occur to the mapping interface 106-4 invoking 
15 various methods at step 314 (e.g., startDocument, startElement, characters, endElement, 

endDocument, etc.); 

(f) in the startDocument and/or startElement methods the mapping interface 106-4 
creates the software object 1 10 at step 316; and 

(g) in the endElement method the mapping interface 106-4 sets the element into the 
20 software object 1 1 0 at step 3 1 8. 
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The SAX API, discussed above, includes many specifications known in the art. The present 
invention is concerned with creating a class that implements a "ContentHandler" interface, 
which is a callback interface used by XML parsers to notify a program of SAX events as they are 
found in the XML document. The interface is used with the XML2xBufferedContentHandler 
5 class 106-2 and the XML2xInputSource class 106-1. The SAX API also provides a 

"DefaultHandler" implementation class for the "ContentHandler" interface. An example I 
"XML-JAVA CUSTOMER", detailed below, extends the "DefaultHandler" to generate a 
customer Java Bean from a customer XML document. 

10 EXAMPLE I 

XML- JAVA CUSTOMER 
The following components (detailed below) are part of example I: 

(A) customer.xml: the input XML document 108 sample; 

(B) XML2CustomerMapping.java: the handler class 106-2 that the parser 104 calls back 
15 to. It contains the instructions to construct the customer object and establish its values; 

(C) execute.java: the program of the mapping class/interface 106-3, 106-4 used to 
execute mapping from XML to Java and from Java to XML (for Example II below); 

(D) customer .java: the output customer Java Bean 110; and 

(E) CustomerSymbols.java: contains integer constants and a hashmap. The hashmap is 
20 used to map the names of tags to integer constants for use in 

XML2CustomerMapping.j ava. 
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A. Input XML document (customer.xml) is provided below. 

//START customer.xml 
<?xml version="l . 0"?> 
5 <customer> 

<FirstName>Jane</FirstName> 
<LastName>Doe</LastName> 
<CustId>xyz . 123</Custld> 
</ customer > 
10 //END customer.xml 

B. A program (XML2CustomerMapping.java), with some reductions for conciseness, to 
construct the customer object and to set values into it (i.e. a handler that the event parser calls 
back to) is provided below. 

15 

//START XML2CustomerMapping.java 

public class XML2CustomerMapping extends 

com . xxx . xml2xmapping . XML2xMappingImpl { 

private StringBuffer f ieldCurrentQualif iedElementName = new 
20 StringBuf fer ( " " ) ; 

private Customer f ieldCustomer ; 

private Stack elementStack; 

* XMLCustomerlnf o2RecordCustomerInf oMapper constructor comment, 
public XML2CustomerMapping( ) { 

25 super ( ) ; 

elementStack = new Stack(); 

} 

* characters method comment. 

public void characters (char [ ] ch, int start, int length) throws 
30 org.xml . sax. SAXException { 
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switch (this . f ieldCurrentElementSymbol ) { 

case Customer Symbols . CUSTOMER_FIRSTNAME : 
case Customer Symbols . CUSTOMER_LASTNAME : 
case Cus tomer Symbol s .CUSTOMER_ID: 
5 ( (StringBuf fer) elementStack. lastElement ( ) ) . append (ch, start , 1 

ength) ; 

break; 



10 } 

* endElement method comment, 
public void endElement (String namespaceURI , String localName, 
String rawName) throws org.xml . sax. SAXException { 
String symbolName; 
15 if (namespaceURI . equals ( " " ) ) symbolName = rawName; 

else symbolName = namespaceURI + "_*• + localName; 
this . f ieldCurrentElementSymbol = 
Customer Symbols .getSymbol (symbolName) ; 
// Get the value 
20 String value = 

( (StringBuf fer) elementStack. pop ( ) ) . toString ( ) ; 
switch (this . f ieldCurrentElementSymbol ) { 

case CustomerSymbols . CUSTOMER_FIRSTNAME : { 

this . f ieldCustomer . setFirstName (value) ; 
25 break; 

} 

case CustomerSymbols . CUSTOMER_LASTNAME : { 

this . f ieldCustomer . setLastName (value) ; 
break; 

30 } 
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case Customer Symbol s.CUSTOMER_ID: { 

this . f ieldCustomer .setld( value) ; 
break; 

} 

5 } 

this . f ieldCurrentElementSymbol = 0; 

} 

* @return com. xxx. connector .mapping. xml . test .Customer 
public Customer getCustomer ( ) { 
10 return this . f ieldCustomer ; 

} 

* startElement method comment, 
public void startElement (String namespaceURI , String localName, 
String rawName, org. xml . sax. Attributes atts) throws 
15 org. xml . sax. SAXException { 

String symbolName; 

if (namespaceURI . equals ( 11 " ) ) symbolName = rawName; 
else symbolName = namespaceURI + + localName; 

this . f ieldCurrentElementSymbol = 
20 Customer Symbols .getSymbol (symbolName) ; 

elementStack. push (new StringBuf f er ( ) ) ; 
switch ( this . f ieldCurrentElementSymbol ) { 
case CustomerSymbols .CUSTOMER: { 

this . f ieldCustomer = new Customer ( ) ; 
25 break; 

} 

} 

} 
} 

30 //END XML2CustomerMapping.java 
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C. A program (execute.java), with reductions for conciseness, used to execute mapping from 
XML to Java (and from Java to XML as detailed in Example II below). 

//START execute Java 
5 package com. xxx.xml2xmapping. sample. customer ; 

import java.io.*; 
import org. xml . sax. * ; 
public class Execute { 

* Execute constructor comment. 
10 public Execute () { 

super ( ) ; 

} 

* Starts the application. 

* @param args an array of command- line arguments 
15 public static void main (java. lang. String [ ] args) { 

int numlterations = 1; 

XML2CustomerMapping inMapping = new XML2CustomerMapping ( ) ; 

Customer2XMLMapping outEventBasedMapping = new 
Customer2XMLMapping ( ) ; 
20 // Create the XML»2Customer handler and the Customer2XML handler 

XML2CustomerMapping in Mapping = new XML2CustomerMapping ( ) ; 
Customer2XMLMapping outEventBasedMapping=new 
Customer2XMLMapping( ) ; 
// read in the customer. xml file 
25 ByteArraylnputStream inStream = null; 

try { 

FilelnputStream f ilelnputStream = new 
FilelnputStream ( "customer .xml" ) ; 

byte[] bytes = new byte [f ilelnputStream. available ()] ; 
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f ilelnputStream . read (bytes , 0 , 
filelnputStream. available ( ) ) ; 

inStream = new ByteArraylnputStream (bytes ) ; 
} catch (Exception e) { 
5 e . prints tackTrace ( ) ; 

} 

ByteArrayOutputStream outStream = new 
ByteArrayOutputStream( ) ; 
try { 

10 long ts = System. currentTimeMi 11 is () ; 

for (int i=0; i<numIterations ; i++) { 
// inbound mapping 

// map from XML document to customer Java Bean 
inStream. reset ( ) ; 
15 inMapping.setlnputStream (inStream) ; 

inMapping . execute ( ) ; 

// some execution, here a connector would be called 

// get the customer object and print its contents 

Customer aCustomer = inMapping . getCustomer () ; 
20 System. out .print In ( "First name from XML document is 

" +aCustomer . getFirstName ( ) ) ; 

System. out .print In ( "Last name from XML document is 
" +aCustomer . getLastName ( ) ) ; 

System. out .print In ( "Customer id from XML document is 
25 " +aCustomer . get Id ( ) ) ; 

// Change the values on the customer object 

aCustomer . setFirstName ( "James " ) ; 

aCustomer . setLastName ( "Bond" ) ; 

aCustomer . setld ( " 007 " ) ; 
30 // outbound mapping 
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// map from Java to XML 

outEventBasedMapping. setCustomer (aCustomer) ; 
/ /outEventBasedMapping . setOutputStream ( outStream) ; 
outEventBasedMapping . setOutputStream ( System . out ) ; 
5 outEventBasedMapping . execute ( ) ; 

} 

long te = System. currentTimeMillis () ; 
System. out .print In ( "Average time "+(te- 
ts) /numIterations+"ms . " ) ; 
10 } catch (Exception e) { 

e . prints tackTrace ( ) ; 

} 

} 
} 

1 5 //END execute.j ava 

D. A customer Java Bean (customer Java) is detailed below. A Java Bean is a reusable 
component that adheres to a standard design architecture known in the art. A Bean is a class 
object that may or may not be visible at run time. JavaBeans provide a component architecture, 
20 a standard framework for developing components. 

//START customer.java 

package com. xxx.xml2xmapping. sample . customer ; 
public class Customer { 
25 private j ava . lang. String f ieldFirstName = new StringO; 

private j ava . lang. String f ieldLastName = new StringO; 
private j ava . lang. String fieldld = new StringO; 
* Customer constructor comment, 
public Customer () { 
30 super ( ) ; 
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} 

* Gets the firstName property ( java. lang. String) value. 

* ©return The firstName property value. 

* @see #setFirstName 

5 public java. lang. String getFirstName ( ) { 
return f ieldFirstName; 

} 

* Gets the id property (java. lang. String) value. 

* ©return The id property value. 
10 * ©see #setld 

public java. lang. String getldO { 
return fieldld; 

} 

* Gets the lastName property (java. lang. String) value. 
15 * ©return The lastName property value. 

* ©see #setLastName 

public java. lang. String getLastName ( ) { 
return f ieldLastName; 

} 

20 * Sets the firstName property ( java . lang. String) value. 

* ©param firstName The new value for the property. 

* ©see #getFirstName 

public void setFirstName (java. lang. String firstName) { 
f ieldFirstName = firstName; 

25 } 

* Sets the id property (java. lang. String) value. 

* ©param id The new value for the property. 

* ©see #getld 

public void setld ( java . lang . String id) { 
30 fieldld = id; 
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} 

/ * & 

* Sets the lastName property (java. lang. String) value. 

* @param lastName The new value for the property. 
5 * @see #getLastName 

public void setLastName (java. lang. String lastName) { 
f ieldLastName = lastName; 

} 
} 

1 0 //END customer.j ava 

As shown in Example I, mapping from XML to Java is efficient because the parser 104 
processes events for all start, element and end tags, which improves tracking of the events. 

15 As a further example, consider expanding the single customer XML document to an array of 

customers. To generate an array of customer java beans follow this procedure: 

(i) use the startElement for Customers to create a vector; 

(ii) in the startElement for each Customer create a Customer object; and 

(iii) use the startElement, getElement, endElement events for FirstName, LastName, and 
20 CustID to populate the Customer object, endElement for Customer to insert the Customer 

object into the vector, and endElement for Customers to create an array of Customers 
from the vector and set it into the Java object being working with. 

A stack is maintained by the parser 104 for recursive XML structures (i.e., XML elements that 
25 represent lists of lists). For each startElement an object is created. The stack can be used to 
keep state as required. Once a child element is created it can be set into its parent object. 

SOFTWARE OBJECT TO XML MAPPING 
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With reference to Fig. 2, the OBJECT-XML mapping module 114 includes the following 
components: 

(a) a handler interface 114-1 (X2XMLHandler) for managing parsing events; 

(b) a mapping interface 114-2 (X2XMLMapping) for executing the mapping and setting 
an output target stream; 

(c) a mapping class 114-3 (X2XMLMappingImpl) that provides methods for mapping 
from the input Java object 1 16 to the output XML document 118; and 

(d) an output target class 114-4 (X2XMLOutputTarget) to implement the output XML 
document 1 1 8. 

Table Ml 14-1 summarizes the main functions (i.e., not exhaustive) of the handler interface 1 14- 
1 (X2XMLHandler). The mapping module 114 implements the interface 114-1 and registers an 
instance with a JSP container. The document template 112 makes call backs to the mapping 
module 114 for basic document related events like the start and end of elements and to get an 
element value. 
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TABLE Ml 14-1 



FUNCTION 


DESCRIPTION 


getEiementValueQ 


Returns the value of an element. This is used when 
working with simple types that are not scoped by start 
and end element tags. 


endElement() 


Receives notification of the end of an element. This is 
used for maintaining state when working with a 
complex type. 


getElementAttributeQ 


Returns the specified attribute's value. This is used 
when working with a complex type that is scoped by 
start and end element tags. 


getElementRepetitions() 


For a repeating element, this returns the number of 
repetitions. 


isOptionalAttributePresentQ 


Returns true if the optional attribute is present, 
otherwise returns false. This is used in the XML 

Hnnimpnt tpmnlate f TSIP^ 119 for cnntrollinp whpfhpr 

name and value are generated for an optional attribute 
in the XML document 118. This is used when working 
with a complex type that is scoped by start and end 
element tags. 


startElementQ 


Receives notification of the beginning of an element. 
This is used for maintaining state when working with 
complex types. 



In general, a container is an entity that provides life cycle management, security, deployment and 
runtime services to components. There are many specific types of containers (Web, JSP, servlet, 
applet etc.) that provide component-specific services. A servlet container is a container that 
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provides network services over which requests and responses are sent, decodes requests, and 
formats responses. A JSP container is a container that provides the same services as a sen/let 
container and an engine that interprets and processes JSP pages into a servlet. 

5 X2XMLHandier 114-1 provides a mirror (although not identical) image of parsing events to that 
produced by the parser 104. In effect, the structure provided by the parser 104 is mirrored in the 
path from X2XML. 

When the parser 104 is implemented using SAX the events are received by the handler 106-2 
10 (i.e., effectively a callback mechanism) that processes them. In this example, the handler 106-2 
is used to populate a Java class. 

When the template 112 is invoked, it calls back to the X2XMLHandler interface 114-1. The 
handler 114-1 processes the callback by obtaining the requested data and maintaining the state of 
15 parsing. 

While the handler interface 114-1 is similar in terms of the various functions performed by the 
XML-OBJECT mapping module 106 there are certain differences. An element name is 
generated or hand coded, and is not taken from a schema with "namespace" support. The 
20 element name can be made unique for each element. Therefore, only a name parameter is 
required on the startElement and endElement methods. 

When mapping is performed by the XML-OBJECT mapping module 106, the input source class 
106-1 (i.e., an XMLReader) returns the name of the element as a string. In the mapping 
25 class/interface 106-3, 106-4 the element name is paired with a unique number. This number is 
used in a switch statement to control the processing of the elements. In the OBJECT-XML 
module 1 14, processing is optimized and coding assistance is improved by defining the element 
name as an integer constant. Therefore, callbacks to these methods use integer constants instead 
of strings. 
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The order of events in the handler interface 114-1 mirrors the order of information in the object 
116 themselves. 

The XML document template 112 (written using Java Server Pages technology), uses the coding 
5 style detailed below. JSP technology separates the user interface from content generation 
enabling changing to the overall page layout without altering the underlying dynamic content. 
JavaServer Pages is an extension of the Java Servlet technology, which is well known to those 
skilled in the art. 

1 0 XML document template 112 - JSP coding style example 

Callbacks are coded for the start and end tags of the document 1 1 8 and for complex 
types. This allows the handler 114-1 to maintain state. In the JSP XML document 
template 1 12, the start and end tags are also coded directly so that they will be directed to 
the targeted output stream. When working with a simple type, callbacks do not have to 

15 be coded, but start and end tags should still be coded so that they will be directed to the 

target output stream. 

If a complex or simple type is optional then isOptionalElementPresent() is used in a 
conditional clause within the template 112 to control whether the optional element is 
20 generated. 

If an attribute is optional then isOptionalAttributePresent(int attributeName) is used in a 
complex type and a isOptionalAttributePresent(int elementName, int attributeName) in a 
simple type. If the element type is a repeating simple type then determine if it contains 
25 an optional attribute using a isOptionalAttributePresent(int index, int elementName, int 

attributeName) method. 

For repeating elements, getElementRepetitions method is used to return the number of 
repeating elements. This is used to construct a loop in the template 112 to process each 
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element. For simple types, the template 112 should contain the start and end tags and 
call a getElementValue(int index, int elementName) to obtain the value. For complex 
types, since state must be maintained the template 112 should invoke the startElement(int 
index, int elementName) and endElement(int index, int elementName) methods. 

Table Ml 14-2 summarizes the main functions (i.e., not exhaustive) of the mapping interface 
114-2 (X2XMLMapping). The mapping interface 114-2 executes the mapping function 
(between Java and XML) and establishes an output target stream. The mapping interface 114-2 
extends the handler interface 114-1, which provides the document template 112 call back 
methods necessary for generating the output XML document 118. 



TABLE Ml 14-2 



FUNCTION 


DESCRIPTION 


executeQ 


Performs the mapping that will create the output XML 
document 118. 


setOutputStreamQ 


Sets the output stream to which the output XML document 
118 will be generated. 



Table Ml 14-3 summarizes the main functions (i.e., not exhaustive) of the mapping class 114-3 
(X2XMLMappingImpl). The mapping class 114-3 provides the methods for mapping from the 
input Java object 1 16 to the output XML document 118. As discussed above in relation to the 
definitions of class and interface, the X2XMLMappingImpl class 1 14-3 is not used directly, but 
is sub-classed with content added to appropriate methods depending on document type 
definitions for the output XML document 1 1 8 to be mapped to and the input Java object 1 16 it is 
mapping from. 

TABLE Ml 14-3 



FUNCTION 



DESCRIPTION 
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execute() 


Performs the mapping that will create the output XML 
document 1 1 8 


setOutputStreamQ 


Sets the output stream to which the output XML document 
1 1 8 will be generated 



Table Ml 14-4 summarizes the main functions (i.e., not exhaustive) of the output target class 
5 114-4 (X2XMLOutputTarget). 

X2XMLOutputTarget class 1 14-4 allows the XML document 1 18 to be written to a byte stream 
or a character stream. Class 114-4 provides optimizations, such as allowing the byte stream to 
be targeted to the output stream of a servlet. Therefore, the XML document 1 18 is not buffered 
1 0 before being written out. 

TABLE Ml 14-4 



FUNCTION 


DESCRIPTION 


close() 


Closes output stream and releases any system resources 
associated with the stream 


flush() 


Flushes output stream and forces any buffered output bytes to 
be written out 


write() 


Writes bytes from a specified byte array to the output stream 



In summary, the X2XMLMappingImpl class 114-3 implements the X2XMLMapping interface 
20 114-2. The X2XMLMapping interface 114-2 extends the X2XMLHandler interface 114-1. 

Therefore, the X2XMLMappingImpl class 114-3 implements the methods defined in the 
X2XMLHandler interface 114-1. 

With reference to Fig. 4, a method 400 is illustrated showing the general steps that are performed 
25 to map the software object 1 1 6 (e.g., a Java Bean) to the XML document 118: 
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(a) obtain an instance of the mapping interface 114-2 (e.g., X2XMLMapping) for 
implementing the mapping from input object X 1 16 to the output XML document 1 18 at 
step 402; 

(b) set the software object 116 and an output stream for the XML document 1 18 in the 
5 mapping interface 1 14-3 at step 404; 

(c) invoke the mapping interface 1 14-2 at step 406; 

(d) create a JSP container at step 408; 

(e) the mapping interface 114-2 invokes the JSP container using the JSP XML template 
1 12 that will create the XML document 1 18 at step 410; 

10 (f) the JSP container compiles and executes the JSP XML template 1 12 at step 412; 

(g) the compiled JSP XML template 1 12 starts writing, at step 414, the XML document 
1 18 to the specified output stream (from step 404); 

(h) when appropriate for element/attribute data and for start/end tags, at step 416, the 
compiled JSP XML template 112 calls back to the mapping interface 114-2 to maintain 

15 state of processing and to add data to the output XML document 118 (data is retrieved 

from the software object 1 16; 

(i) the compiled JSP XML template 112 can optionally call, at step 418, an 
isOptionalElementPresent method or an isOptionalAttributePresent method to determine 
if certain portions of the XML document should be generated; 

20 (j) the JSP XML template 1 12 calls back to a getElementRepetitions method to determine 

how many times it should loop over generation of certain portions of the XML document 
at step 420; and 

(k) the state of processing is maintained by a stack at step 422; this is useful when 
generating complex types within an XML document where an array occurs, recursion 
25 occurs or a complex type is contained within another complex type. 

Mapping from Java to XML uses the XML document template 1 12, which is coded with similar 
standards imposed by the parser 104, which processes events (at least for complex objects). For 
example, for complex types, start and end tags must be coded (not required for primitive types). 
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An example II "JAVA-XML CUSTOMER", detailed below, generates an output customer XML 
document from a input customer java object. 

EXAMPLE II 

5 JAVA-XML CUSTOMER 

The following components (detailed below) are part of example II: 

(A) Customer2XMLMapping.java: the handler class 114-1 that the JSP 1 12 calls to 
obtain values from the input customer Java object 1 16 to populate the output XML 

10 document 118; 

(B) customer jsp: the JSP template 1 12 used to generate the output XML document 1 1 8; 

(C) CustomerSymbols.java: contains constants and a hashmap. The hashmap is used to 
map the names of the tags to integer constants. The JSP template 1 12 uses the integer 
constants; and 

1 5 (D) execute.java: the program of the mapping class/interface 1 14-2, 114-3 used to 

execute mapping from Java to XML and from XML to Java (as provided above as item C 
for Example I). 

A. A program (Customer2XMLMapping.java), with some reductions of conciseness, to 
20 construct the XML document from the input Java object. 

//START Customer2XMLMapping.java 

package com . xxx . xml2xmapping . sample . customer ; 
import java.util . * ; 
25 import com. ibm.xml2xmapping.util . * ; 

public class Customer 2XMLMapping extends 
com . xxx . xml2xmapping . X2XMLMappingImpl { 
private Customer f ieldCustomer ; 

I * * 
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* Customer2XMLMapping constructor comment. 

*/ 

public Customer2XMLMapping( ) { 
super ( ) ; 

5 fieldPageName= "customer . jsp" ; 

} 

/ * * 

* getElementRepetitions method comment. 

*/ 

10 public int getElementRepetitions ( int name) { 
switch (name) { 
} 

return 0; 

} 

15 /** 

* getElementValue method comment. 

*/ 

public String getElementValue (int name) { 
switch (name) { 
20 case CustomerSymbols . CUSTOMER_FIRSTNAME : { 

return this . f ieldCustomer . getFirstName ( ) ; 

} 

case CustomerSymbols .CUSTOMER_LASTNAME: { 

return this . f ieldCustomer . getLastName ( ) ; 

25 } 

case Cus tomer Symbol s .CUST0MER_ID: { 

return this . f ieldCustomer . getld ( ) ; 

} 

} 

30 return " " ; 
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} 

* getElementValue method comment. 

public String getElementValue ( int index, int name) { 
switch (name) { 
5 } 



return " " ; 

} 

* @param aCustomer com.xxx.xml2xmapping. sample. customer. Customer 
10 public void setCustomer (Customer aCustomer) { 
this . f ieldCustomer = aCustomer; 

} 
} 

//END Customer2XMLmapping.java 

15 

B. A document template (Customer.jsp), with some reductions for conciseness, in JSP for 
module 112. 



// START Customer.jsp 
20 <%@ page import=" com. ibm.xml2xmapping. * " %> 
<%@ page 

import = " com . ibm . xml2xmapping . sample . customer . Cus tomer Symbol s " %> 
<%X2XMLHandler handler = 

(X2XMLHandler) request .getAttribute ( "com. ibm.xml2xmapping.X2XMLHan 
25 dler"); 

handler .setWriter( out) ;%> 
<?xml version^" 1 . 0" ?> 
<customer> 

<FirstName><%=handler . getElementValue (CustomerSymbols .CUSTOMER_FI 
30 RSTNAME) %></FirstName> 

CA9-2001-0007 33 



<LastName><%=handler . getElementValue (CustomerSymbols . CUSTOMER_LAS 
TNAME) %></LastName> 

<CustIdx%=handler . getElementValue (CustomerSymbols . CUSTOMER_ID) %> 
</CustId> 
5 </customer> 

//END Customer.jsp 

C. A program (CustomerSymbols Java), with some reductions for conciseness, of a hashmap 
and constants used by customer.jsp. 

10 

// START Customersymbols.java 

package com. xxx.xml2xmapping. sample. customer ; 
import java.util .HashMap; 
public class CustomerSymbols { 
15 public static final int CUSTOMER = 1; 

public static final int CUSTOMER_F I RSTNAME = 2; 

public static final int CUSTOMER_LASTNAME = 3; 

public static final int CUSTOMER_ID = 4; 

private static CustomerSymbols f ieldlnstance; 
20 private HashMap f ieldName2SymbolDictionary ; 

private static Object anObject = new Object (); 
* CustomerlnfoElementSymbols constructor comment, 
private CustomerSymbols ( ) { 

super ( ) ; 

25 this . f ieldName2SymbolDictionary = new HashMapO; 

this . f ieldName2SymbolDictionary .put ( "customer" , new 
Integer (CustomerSymbols. CUSTOMER) ) ; 

this . f ieldName2SymbolDictionary .put ( "FirstName" , new 
Integer (CustomerSymbols .CUSTOMER_F I RSTNAME) ) ; 
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this . f ieldKame2SymbolDictionary .put ( "LastName" , new 
Integer (Customer Symbols . CUSTOMER_LASTNAME ) ) ; 

this . f ieldName2SymbolDictionary .put ( "Custld" , new 
Integer (Customer Symbols .CUSTOMER_ID) ) ; 
5 } 

* ©return int 
* ©param elementName java. lang. String 
public static int getSymbol (String elementName) { 
if (Customer Symbols . f ieldlnstance == null) { 
10 synchronized (anObject) { 

if (Customer Symbols . f ieldlnstance == null) { 
CustomerSymbols . f ieldlnstance = new 

CustomerSymbols ( ) ; 

} 

15 } 
} 

return 

( (Integer) CustomerSymbols . f ieldlnstance . f ieldName2SymbolDictionar 
y. get (elementName) ) . intValue ( ) ; 
20 } 
} 

// END Customersymbols.java 

To generate the XML document for the array of customers situation discussed in conjunction 
25 with Example I a sample of the revised customer.jsp is provided below: 

f o r ( i n t i = 0 ; 

i<handler .getElementRepetitions (CustomerSymbols .CUSTOMERS ) ; i 
+ + ) { 

<%handler . startElement ( i , CustomerSymbols . CUSTOMER) ; %> 
30 <customer> 
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<FirstName> 

<%=handler . getElementValue (Customer Symbols . CUSTOMER_FIRSTNAM 

E) %></FirstName> 

<LastName> 

5 <%-handler . getElementValue (CustomerSymbols . CUSTOMER_LASTNAME 

) %></LastName> 

<CustIdx%=handler . getElementValue (CustomerSymbols . CUSTOMER_ 

ID) %></CustId> 

</customer> 

10 <%=handler . endElement ( i , CustomerSymbols . CUSTOMER) ; %> 

<%}%> 

The handler 114-1 determines the array size (i.e., how many loops are to be executed) and 
returns in the getElementRepitions method. When the customer .jsp calls startElement with the 
15 index and name, the handler 114-1 sets a reference to that particular customer object in the array. 

To handle recursion, the handler 114-1 uses a stack. As the object recurses, the handler 114-1 
pushes onto the stack with a startElement, and pops with the endElement. The working object is 
the object on top of the stack. 

20 

If an object is optional then the isOptionalElement() or isOptionalAttribute() methods are used to 
determine if the object exists. The processing in the customer .jsp is revised to add a conditional 
statement that uses a returned boolean for one of the isOptionalxxx methods. 
In summary, advantages of an exemplary embodiment of the present include: 
25 (a) providing a common framework for mapping from an XML document to a Java 

object and from a Java object to an XML document, wherein the framework uses a 

handler that masks how a property is obtained for mapping; 

(b) use of readily available tools (e.g. SAX parser, JSP) to instantiate the mapping 
methods (XML/Java) of the present invention; and 
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(c) providing interfaces and classes (in Java environment) that simplify the structure of 
the mapping process of the present invention and makes the mapping process similar for 
both mapping directions. 



CA9-2001-0007 



37 



CLAIMS : 

1. A computer-implemented method for converting a data structure representing a software 
object to structured language elements of a document, the method comprising: 

(a) generating a structured language element template document; 
5 (b) reading properties from the software object, the properties being associated with the 

structured language elements of the document; 

(c) using the properties, obtaining constructs defined by the structured language elements 
based on the association between the properties and the structured language elements; and 

(d) populating the structured language element template document with the constructs. 

10 

2. The computer-implemented method of claim 1, wherein step (c) includes direct call back 
to the software object to obtain properties that represent the constructs that define structure and 
content of the document. 

15 3. The computer-implemented method of claim 1, wherein step (c) includes creating an 

object model that represents structure and content of the document. 

4. The computer-implemented method of claim 1 , wherein the structured language elements 
represent Extensible Markup Language (XML) constructs. 

20 

5. The computer-implemented method of claim 1, wherein step (c) includes constructing a 
loop in the template document to process repeating structures language elements. 
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6. A computer-implemented method for converting structured language elements of a 
document to a data structure representing a software object, the method comprising: 

(a) reading each of the structured language elements of the document; 

(b) determining a property, selected from a set of available properties defined by the data 
5 structure of the software object, associated with structured language elements of the document; 

and 

(c) populating the properties of the data structure representing the software object with 
structured language element values from the document. 

10 7. The computer-implemented method of claim 6, wherein step (a) includes generating 
events that represent structure and content of the document. 

8. The computer-implemented method of claim 6, wherein step (a) includes calling back to 
a handler with events that represent structure and content of the document. 

15 

9. The computer-implemented method of claim 6, wherein step (a) includes creating an 
object model that represents structure and content of the document. 

10. The computer-implemented method of claim 6, wherein the structured language elements 
20 represent Extensible Markup Language (XML) constructs and step (a) further includes enforcing 

Document Type Definition (DTD) and XML schema standards. 

11. The computer-implemented method of claim 10, further comprising maintaining a stack 
for recursive XML constructs. 

25 
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12. A system for converting a software object containing properties to a document defined by 
structured language elements, the system comprising: 

(a) a document template; 

(b) a handler interface for providing a representation of the structured language elements 
5 of the document based on call backs made by the document template; 

(c) a mapping module, in communication with the handler interface, for converting 
properties of the software objects to structured language elements recognized by the document; 
and 

(d) an output target class, in communication with the mapping module, for writing the 
10 structured language elements generated in step (c) to the document. 

13. The system of claim 12, wherein the mapping module includes a mapping interface for 
executing the conversion of the properties to the structured language elements and for setting an 
output target stream of the document and a mapping class for providing methods used by the 

1 5 mapping interface. 

14. The system of claim 13, wherein the output target stream is defined as a buffer. 

15. The system of claim 13, wherein the output target stream is defined as a response stream 
20 of a servlet. 

16. The system of claim 12, wherein the structured language elements represent Extensible 
Markup Language (XML) constructs. 

25 17. The system of claim 16, wherein the document template is created using JavaServer 

Pages (JSP). 



CA9-2001-0007 



18. A system for converting a document containing structured language elements to a 
software object, the system comprising: 

(a) a parser for obtaining events representative of features of the document; 

(b) an input source class for reading the document; 

5 (c) a content handler class, in communication with the input source class, for 

implementing a buffer for the events obtained by the parser; and 

(d) a mapping module, in communication with the content handler class, for converting 
the events obtained by the parser to properties for the software object. 

10 19. The system of claim 18, wherein the mapping module includes a mapping interface for 

executing the conversion of the events to the properties and for setting an output target stream of 
the software object and a mapping class for providing methods used by the mapping interface. 

20. The system of claim 19, wherein the structured language elements represent Extensible 
1 5 Markup Language (XML) constructs. 

21 . A method of converting a software object having properties to a document represented by 
structured language elements, the method comprising: 

(a) supplying the software object to an instance of an invoked mapping interface; 
20 (b) compiling and executing a template using an instance of an invoked container; and 

(c) writing the document to a specified output stream using the compiled template. 

22. The method of claim 21, further comprising calling back to the mapping interface to 
maintain state of processing. 

25 

23. The method of claim 21, further comprising calling an isOptionalElementPresent method 
through the compiled template to determine if selected portions of the document are to be 
generated. 
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24. The method of claim 21, further comprising calling an isOptionalAttributePresent 
method through the compiled template to determine if selected portions of the document are to 
be generated. 

5 25. The method of claim 21, further comprising maintaining a state of processing using a 

stack when generating complex types within the document, said complex types selected from the 
group consisting of: an array, recursion and a complex type being contained within another 
complex type. 

10 26. The method of claim 25, wherein the state of the stack is maintained by call backs from 
the compiled template to the mapping interface to indicate when the complex types start and end. 

27. The method of claim 21, further comprising calling a getElementRepetitions method to 
determine how many times the template loops over selected portions of the document. 

15 

28. The method of claim 21, wherein the structured language elements represent Extensible 
Markup Language (XML) constructs and the template is created using JavaServer Pages (JSP). 

29. A method of converting a document containing structured language elements to a 
20 software object, the method comprising: 

(a) supplying the document to an instance of an invoked mapping interface; 

(b) registering the mapping interface as a content handler; 

(c) parsing the document using an instance of an invoked parser; and 

(d) populating the software object with properties associated with structured language 
25 elements parsed from the document through call backs made to the mapping interface. 

30. The method of claim 29, wherein step (d) includes call backs to invoke methods selected 
from the group consisting of: startDocument, startElement, characters, endElement, and 
endDocument. 
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31. The method of claim 30, wherein the startDocument and startElement methods executed 
by the mapping interface creates the software object. 

32. The method of claim 29, wherein the endElement method executed by the mapping 
5 interface sets the properties into the software object. 

33. The method of claim 29, wherein the structured language elements represent Extensible 
Markup Language (XML) constructs. 

10 34. A computer program product for converting a data structure representing a software 

object to structured language elements of a document, the computer program product comprising 
computer readable program code devices for: 

(a) generating a structured language element template document; 

(b) reading properties from the software object, the properties being associated with the 
1 5 structured language elements of the document; 

(c) using the properties, obtaining constructs defined by the structured language elements 
based on the association between the properties and the structured language elements; and 

(d) populating the structured language element template document with the constructs. 

20 35. The computer program product of claim 34, wherein step (c) includes direct call back to 
the software object to obtain events that represent the constructs that define structure and content 
of the document. 

36. The computer program product of claim 34, wherein step (c) includes creating an object 
25 model that represents structure and content of the document. 

37. The computer program product of claim 34, wherein the structured language elements 
represent Extensible Markup Language (XML) constructs. 
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38. The computer program product of claim 34, wherein step (c) includes constructing a loop 
in the template document to process repeating structures language elements. 

39. A computer program product for converting structured language elements of a document 
to a data structure representing a software object, the computer program product comprising 
computer readable program code devices for: 

(a) reading each of the structured language elements of the document; 

(b) determining a property, selected from a set of available properties defined by the data 
structure of the software object, associated with structured language elements of the document; 
and 

(c) populating the properties of the data structure representing the software object with 
structured language element values from the document. 

40. The computer program product of claim 39, wherein step (a) includes generating events 
that represent structure and content of the document. 

41. The computer program product of claim 39, wherein step (a) includes calling back to a 
handler with events that represent structure and content of the document. 

42. The computer program product of claim 39, wherein step (a) includes creating an object 
model that represents structure and content of the document. 

43. The computer program product of claim 39, wherein the structured language elements 
represent Extensible Markup Language (XML) constructs and step (a) further includes enforcing 
Document Type Definition (DTD) and XML schema standards. 

44. The computer program product of claim 43, further comprising maintaining a stack for 
recursive XML constructs. 
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SYSTEM AND METHOD OF MAPPING BETWEEN SOFTWARE OBJECTS AND 
STRUCTURED LANGUAGE ELEMENT BASED DOCUMENTS 



ABSTRACT OF THE DISCLOSURE 

5 

A method and system that provides a common framework for mapping between a 
document (e.g. an XML document) and a software object (e.g. a Java object). The framework 
uses a handler that masks how a property is obtained for mapping. This results in mapping code 
that has a common appearance for both directions of mapping. A mapping between elements of 

10 an XML document and the properties of a Java object is contained in a mapper. A mapper maps 
from the XML document to an object using a parser (such as DOM or SAX). Mapping in the 
other direction (Java to XML) requires that the elements of the XML document be built in a 
particular order to ensure validity of the resulting XML document. The present invention builds 
an XML template document using JSP, for example. Using JSP based templates enables tags of 

15 the document to be written in the JSP, with callbacks to get element and attribute values. 
Further, content can be directed to a buffer, or directly to a response stream of a servlet. 
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